package com.woniuxy.portal;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cache.annotation.EnableCaching;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.scheduling.annotation.EnableScheduling;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.security.crypto.password.PasswordEncoder;

@SpringBootApplication
/*
    指定Mapper接口的扫描包路径：com.woniuxy.portal.mapper
    Spring Boot启动时会自动扫描包下的所有接口，
    将其注册为MyBatis的Mapper代理对象，无需手动配置每个Mapper接口
 */
@MapperScan("com.woniuxy.portal.mapper")
@EnableCaching    // 开启缓存功能
@EnableScheduling // 开启定时任务功能
/*
    显式指定基础包路径，确保Spring能扫描并注册相关组件。
    - com.woniuxy.portal：当前业务模块（如 Controller、Service 等）
    - com.woniuxy.common：通用模块（包括全局异常处理器、断言工具类等）
    若不手动扫描com.woniuxy.common，部分核心功能（如全局异常捕获）将无法生效。
 */
@ComponentScan(basePackages = {"com.woniuxy.portal", "com.woniuxy.common"})
public class PortalApplication {

    public static void main(String[] args) {
        SpringApplication.run(PortalApplication.class, args);
    }

    /**
     * 配置密码编码器Bean
     * 该方法创建并返回一个BCryptPasswordEncoder实例，用于密码的加密和验证
     * 作为Spring管理的单例Bean，整个应用共享同一个实例
     * （不使用 @Scope 注解，Spring Bean 的默认作用域是 singleton（单例））
     * 在应用启动时创建，确保安全组件可用
     *
     * @return PasswordEncoder 返回BCryptPasswordEncoder实例
     */
    @Bean
    public PasswordEncoder passwordEncoder() {
        return new BCryptPasswordEncoder();
    }

}
